docs: add user-facing data catalog page (data.qmd)#146
Merged
rdhyee merged 1 commit intoisamplesorg:mainfrom Apr 24, 2026
Merged
docs: add user-facing data catalog page (data.qmd)#146rdhyee merged 1 commit intoisamplesorg:mainfrom
rdhyee merged 1 commit intoisamplesorg:mainfrom
Conversation
A public-facing companion to SERIALIZATIONS.md (PR isamplesorg#143). Where the catalog is internal reference ("every file with role, size, upstream, consumers"), this page is the researcher/developer landing: - Quick-pick table mapping "if you want to do X → use file Y" - Five copy-pasteable DuckDB snippets (every one executed clean against live R2 URLs during authoring) - H3 tier breakpoint reference for map authors - Cross-links to SERIALIZATIONS, QUERY_SPEC, PQG spec, conformance matrix - Data-source + licensing paragraph pointing to the Zenodo community (without speculating on specific license terms) Lands at the site root alongside pubs.qmd and query-spec.qmd. Note on column naming in snippets: the wide parquet uses `n` for the source column (PQG convention); lite and sample_facets_v2 use the friendlier alias `source`. Flagged inline in the snippet comment so Binder/Colab first-timers don't trip on it. Verified on 2026-04-24: all 6 snippets (incl. the callout quick-start) execute against data.isamples.org, returning non-empty results.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A public-facing companion to SERIALIZATIONS.md (#143). Where the catalog is internal reference, this is the researcher/developer landing.
Contents
Verification
Every snippet on the page was executed against live `data.isamples.org` URLs on 2026-04-24 and returned non-empty results. Two original drafts (intro quick-start and §3.4) were corrected during verification:
How this differs from PR #143
Both live alongside each other. Cross-linked.
Related
🤖 Generated with Claude Code